home *** CD-ROM | disk | FTP | other *** search
/ MacGames Sampler / PHT MacGames Bundle.iso / MacSource Folder / Samples from the CD / Modula / Introduction < prev    next >
Text File  |  1985-06-10  |  7KB  |  184 lines
  1.  
  2. (This is a 'quick and dirty' translation of one of two documents
  3. (which were written in German originally) that came along with the compiler.
  4. (MA))
  5.  
  6. ***********************************
  7. *                                 *
  8. * Modula-2 68K for the Macintosh  *
  9. *                                 *
  10. *********************************** 
  11.  
  12. Pre-Release 4/25/85
  13.  
  14. (This compiler is based on earlier versions for different types of hardware 
  15. written by several people at the ETH Zuerich.
  16. The Macintosh version is beeing written by Peter Fink and Franz Kroenseder
  17. at the 'Institut fuer Informatik, ETH Zuerich'. (MA))
  18.  
  19.  
  20. Overview
  21. ========
  22.  
  23. The three disks contain a Pre-Release of Modula-2 for the Macintosh.
  24.  
  25. The library does not yet allow access to all of the Macintosh's
  26. ROM-Routines, but it is in a coherent and usable state. Compiler and linker
  27. work reliably.
  28.  
  29. Real numbers are implemented and transcendental functions exist in the
  30. library. The library contains routines that allow formatted reading
  31. and writing from/to keyboard, screen and files.
  32.  
  33. The elementary graphics routines in the Macintosh ROM are accessible. You
  34. may also use keyboard and/or mouse for input.
  35.  
  36.  
  37. 'Rules of the game'
  38. ===================
  39.  
  40. This compiler is provided to you on a as-is basis, i.e. we are still working
  41. on it but nevertheless you may already use it.
  42.  
  43. We can't give you any further documentation, neither on our programs
  44. nor on the internals of the Macintosh (except the disk M2-Doku).
  45.  
  46. The disks contain ALL the Software that is available for the moment.
  47.  
  48. We DON'T give any further support. 
  49.  
  50. Don't give away the compiler for commercial purpouses, especially no 
  51. selling!
  52.  
  53. (This is not a product. There is no warranty for anything. Except that the
  54. people who wrote it, did their best (MA))
  55.  
  56.  
  57. Description of the disks contents
  58. =================================
  59.  
  60. There are the three disks: M2-System, M2-Doku and MODLIB.
  61.  
  62.  
  63. M2-Doku: This is a bootable documentation disk.
  64. -------
  65.  
  66.   EDIT         : Text Editor to read and print the text files.
  67.              (as the Editor is a copyrighted product I didn't supply it
  68.              with the compiler. But as you are able to read this, I
  69.          assume, you found some other way to access the files (MA))
  70.   Introduction : the text that you're just reading.
  71.   GUIDE.TEXT   : Description of the compiler and linker covering all
  72.            options and switches. Description of the Modula-2 dialect
  73.          the compiler is working with.
  74.   DEF1 Folder  : This Folder contains the .DEF Files of all library
  75.            routines:
  76.            
  77.     Conversions  : number formatting
  78.     InTerminal   : input of numbers
  79.     M2Files      : file I/O using characters and words
  80.     MathLib0     : transcendental functions and square root
  81.     MathLib1     : more functions, pi and random numbers
  82.     OutFile      : output of numbers to a file
  83.     OutTerminal  : output of numbers to the user
  84.     RealTerminal : input/output of real numbers
  85.     Storage      : dynamic memory management using a heap
  86.     Terminal     : input/output, cursor positioning (input is also
  87.                simulating ASCII, for example Command+X=CAN,
  88.                Command+[=ESC)
  89.     QuickDraw    : Access to the Quickdraw routines
  90.     EventMgr     : event manager of the Mac, interface to mouse and
  91.                keyboard
  92.                
  93.   DEF1 Folder  : This Folder contains the .DEF Files of special modules:
  94.  
  95.     Clock        : clock interface
  96.     Loader       : loading and execution of overlays
  97.     MCLookup     : filename dialog (as used in compiler and linker)
  98.     Options      : service modul for MCLookup
  99.         PascalStrings: conversions between Macintosh- und Modula-2 strings
  100.     SFPackage    : filename dialog (as used in MacWrite or EXEC)
  101.                (MiniFinder (MA))
  102.     OSConstants  : numbers of  Macintosh error messages, halt index,
  103.                some bomb ID numbers
  104.                
  105.                
  106. MODLIB: This disk contains all the files needed in order to compile and
  107. ------  link, i.e. the compiler, the linker and the library
  108.  
  109.     m2comp          : compiler
  110.         m2link       : linker
  111.     Folders      : overlays, .SYM und .LNK files
  112.     
  113. IMPORTANT NOTICE:
  114.     - Do *not* change the name of the disk (MODLIB). Otherwise the compiler
  115.       won't work.
  116.     - The disk may be write protected.
  117.     - There are some .LNK files without corresponding .SYM files. Don't 
  118.       delete these files. (secondary import)
  119.     - As you duplicate the disk, m2comp and m2link sometimes are not copied.
  120.       So you'll have to do this manually (This never happened to me (MA))
  121.     - When linking, during the linker dialog always specify the /D option
  122.       to save disk space (for the moment there is no debugger anyway (MA))
  123.       
  124.       
  125. M2-System: This bootable disk contains the Editor (again I did not provide
  126. ---------  it (MA)) the runtime application EXEC (Loader) and some example
  127.        programs.
  128.  
  129.     EXEC          : runtime application to run Modula-2 programs.
  130.                You may click on a Modula-2 program (as m2comp,
  131.                m2link or *.LOD) or just on Exec. With the editor
  132.                you may choose Exec directly from the TRANSFER menu
  133.                Exec lets you select a program from a file window
  134.                After execution of the program you will return 
  135.                here. Click on CANCEL to quit and return to the
  136.                Desktop
  137.     LISACONVERT  : Application to convert textfiles from the Lisa
  138.                format.
  139.  
  140.     Examples     : Some example programs in .MOD and .LOD format. You
  141.                may delete these in order to get room for your own
  142.                programs.
  143.  
  144. NOTICE:
  145.     - On this disk there must be enough space for the compiler's and
  146.       linker's workfiles. Sometimes you will have to throw away
  147.       some old .LOD files as old versions are not overwritten until
  148.       m2comp and m2link finished their job completly.
  149.     - To compile and link MODLIB and Exec have to be online. To execute
  150.       the programs you only need Exec. There is no need to have the
  151.       M2-Doku disk online to work with the compiler.
  152.  
  153.   
  154. How to start?
  155. =============
  156.  
  157.       - Put the disks M2-System and MODLIB into the drives and boot. Click
  158.     on the document PiRandom.MOD. It will appear in the Editor which
  159.     will be loaded automatically. Choose EXEC from the TRANSFER menu.
  160.     (this won't work unless you rename Exec512 to Exec. Don't try it
  161.     with Exec128 as there just isn't enough memory on a 128 kBytes Mac
  162.     to run the compiler / linker (MA)). Soon Exec will appear. In the
  163.     File window you can see the executable Modula-2 programs. m2comp
  164.     and m2link have to be visible. If not, click on the DRIVE button.
  165.     Now select m2comp and open it. The compiler dialog starts:
  166.     
  167.     source file> pirandom <RETURN>  <--- Type this
  168.     
  169.     After a while compilation will finish. Press any key to return to
  170.     the file window. You may now choose m2link. Type the following
  171.     when the linker dialog starts:
  172.     
  173.     master file> pirandom/D <RETURN>   <--- Type this
  174.     
  175.     Press any key when the linker finished. Now you can select and open
  176.     pirandom.LOD from the file window (if you can't find it, click
  177.     the DRIVE button. The input following hereafter will be passed to
  178.     the program (pirandom). You return to the file window by typing
  179.     some 'Q'. There you may select another program or return to the
  180.     desktop by choosing CANCEL.
  181.     
  182.     Thats all folks… (at least for the moment (MA))
  183.  
  184. (All comments marked with (MA) are my own opinions / comments. Matthias Aebi)